home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 015a / ifp1p150.zip / INFOPLUS.DOC < prev    next >
Text File  |  1992-01-01  |  13KB  |  283 lines
  1. INFOPLUS
  2.  
  3. Version 1.50 Released to the public domain.
  4.  
  5. By Andrew Rossmann, 1/1/92
  6.  
  7. Originally based on Steve Grant's Public Domain SYSID 4.44.
  8.  
  9.   Syntax:
  10.     [d:][path]INFOPLUS [B][D][M][C][NV][H][?]
  11.  
  12.   Where:
  13.     B  = Write to screen using BIOS (default under Desqview)
  14.     D  = Write directly to screen memory (default)
  15.     M  = Use monochrome colors (default under MODE BWxx or MONO)
  16.     C  = Use normal colors (default)
  17.     NV = Do not perform VGA chipset detection
  18.     H or ? = This help screen
  19.  
  20.   A system description for DOS-based PC/XT/AT- and PS/2-class machines.
  21. INFOPLUS generates 18 screens of information about the host system and runs
  22. under DOS versions 3.0 and later.
  23.  
  24.   My primary sources of ideas in INFOPLUS were Ray Duncans "Advanced MS-DOS"
  25. and Terry Dettman's "DOS Programmer's Reference."  The ideas of Prakash
  26. Chandra,Terje Mathisen,Bob Smith, and others appear in various places.  Also
  27. James Howard, John Levine, Mark Aitchison, Jay Caplan, David Tay, Heribert
  28. Eisele.
  29.  
  30.   Some of the techniques INFOPLUS uses are not documented or officially
  31. supported by either IBM or Microsoft.  Where possible I have followed the
  32. undocumented routine with a comment describing my source for the technique.
  33.  
  34.   The following files are included with the runtime program:
  35.  
  36.         INFOPLUS.EXE       - The main program
  37.         INFOPLUS.HIS       - Changes in each version
  38.         INFOPLUS.HLP       - The help screens
  39.         INFOPLUS.DOC       - This file
  40.         INFOPLUS.PIF       - Windows 3 Program Information File
  41.         IP-PIF.DVP         - Desqview Program Information File
  42.         INFOPLUS.ICO       - Icon for Windows 3 Program Manager
  43.         PRINTHLP.EXE       - Program to print some or all .HLP pages
  44.  
  45.   The following files are included with the source code:
  46.  
  47.         INFOPLUS.PAS       - Main file
  48.         IFPGLOBL.PAS       - Global variables, constants, and types
  49.         IFPCOMON.PAS       - Routines common to many of the pages
  50.         IFPRUN.PAS         - General runtime manager
  51.         IFPINIT.PAS        - Initialization routines
  52.         PAGE_xx.PAS        - Each of the pages
  53.         IFPEXTRN.PAS       - Unit for external routines
  54.         IFPSCRPT.PAS       - Unit for screen printing
  55.         IFPHELP.PAS        - Unit for help screens
  56.         INFOPLUS.ASM       - Assembly language procedures
  57.         INFOPLUS.OBJ       - Assembly routines for linking
  58.         PRINTHLP.PAS       - For printing out the help pages
  59.         MAKEHELP.PAS       - Compiles PAGE_xx.INF files into INFOPLUS.HLP
  60.         PAGE_xx.INF        - Help screen for each page
  61.  
  62.    Using INFOPLUS is easy.  Just use the PGUP and PGDN keys to move from
  63. page to page.  HOME and END will move to the first and last pages,
  64. respectively.  If you hit ENTER, you can then type in the page you want to
  65. go to.  If you hit ENTER without typing a new page number, it will re-run
  66. the current page.  Hit ESC to end the program.  Some pages won't fit all on
  67. one screen, for that you hit the DOWN ARROW key to get more information.
  68. Some pages let you hit UP ARROW to review already displayed information.
  69.  
  70.   If you want to save a copy of the information on a screen, hit ALT-P.  A
  71. window will pop up.  You can send your output to a File or the Printer.  If a
  72. File already exists, you can Overwrite it, or Append to it.
  73.  
  74.   If your printer does not support the IBM 'graphics' characters (such as line
  75. drawing), then choose Normal ASCII.
  76.  
  77.   Lastly, you can optionally add an extra header line to the output.  You can
  78. put anything you want there (up to 255 characters.)  The most logical is to
  79. put a little information on what computer your using. ie:  Betty's Office
  80.  
  81.   You can hit F1 during screen displays to get a help screen explaining
  82. what's being displayed. INFOPLUS looks for the environment variable
  83. INFOPLUS, and if found, uses a path given on it to look for INFOPLUS.HLP
  84. (INFOPLUS=C:\UTIL). If no environment variable is found, INFOPLUS will look
  85. in the current directory, then the same directory as the program was found,
  86. then your PATH.
  87.  
  88.   If you have trouble with bad colors on the screen, try setting your computer
  89. to MODE MONO or MODE BW80 before starting INFOPLUS.  INFOPLUS will use a black
  90. and white palette if either of these modes are detected. You can also use
  91. the M command line switch. (INFOPLUS M)
  92.  
  93.   If you are in a 40 column mode, INFOPLUS will run in 80 column, but return
  94. you back to 40 columns upon completion. 132 column modes are not supported
  95. because Turbo Pascal's CRT unit only works with standard modes, and I don't
  96. want to give up all the nice features.
  97.  
  98.   INFOPLUS does support more than 25 lines, although most of the pages are set
  99. up to look best at 25 lines.  Some display modes do not properly return the
  100. correct number of lines.
  101.  
  102.   For ease of use, a utility named PRINTHLP comes with INFOPLUS.  When you
  103. run it, you can have one or all of the help pages sent to your printer (or
  104. any DOS device or file.)  Each information page will be paginated any way
  105. you like.  Each new page will have a small header giving the Infoplus
  106. version it refers to, the page number, and what is on the page.
  107.  
  108. WINDOWS 3.0 NOTES!!!
  109.      You can add INFOPLUS to the Program Manager. Open the group that you
  110.      want to put INFOPLUS in. Select File, New, Program item. Use whatever
  111.      you want for the Description. For Command line, enter INFOPLUS.EXE,
  112.      preceed with a drive and directory if not on your PATH. If you hit
  113.      ENTER, and end up at the screen, select File, Properties. Hit Change
  114.      Icon, and for the file name, use INFOPLUS.ICO. Then OK everything.
  115.      Note that when you minimize Infoplus, you will see a standard DOS
  116.      icon. This can't be changed.
  117.  
  118. Desqview NOTES:
  119.      Infoplus runs safely under Desqview, and is 'Desqview Aware.' If DV is
  120.      detected, Infoplus will write to the screen using BIOS calls unless
  121.      you use the D command line switch. This allows windowed screens even
  122.      on non-386/486's.
  123.  
  124.      IP-PIF.DVP is a sample setup for Infoplus. The settings should be:
  125.  
  126.                                Change a Program
  127.  
  128.  Program Name............: Infoplus
  129.  
  130.  Keys to Use on Open Menu: IP                         Memory Size (in K): 200
  131. ------------------------------------------------------------------------------
  132.  Program...: C:\UTIL\INFOPLUS.EXE     <---Change this for your own setup
  133.  
  134.  Parameters:
  135.  
  136.  Directory.: C:\UTIL   <---Not needed if you use the environment variable
  137. ------------------------------------------------------------------------------
  138.  Options:
  139.                   Writes text directly to screen.......: [N]
  140.                   Displays graphics information........: [N]
  141.                   Virtualize text/graphics (Y,N,T).....: [N]
  142.                   Uses serial ports (Y,N,1,2)..........: [Y]
  143.                   Requires floppy diskette.............: [N]
  144.  
  145.                       Change a Program Advanced Options
  146.  
  147.  System Memory (in K).......:   0   Maximum Program Memory Size (in K)..:
  148.  
  149.  Script Buffer Size.......:  1000   Maximum Expanded Memory Size (in K):   16
  150.  
  151.  Text Pages: 2  Graphics Pages: 0   Initial Mode:        Interrupts: 00 to FF
  152. ------------------------------------------------------------------------------
  153.  Window Position:
  154.     Maximum Height:  25       Starting Height:  25       Starting Row...:   0
  155.     Maximum Width.:  80       Starting Width.:  80       Starting Column:   0
  156. ------------------------------------------------------------------------------
  157.                                 Shared Program
  158.  Pathname..:
  159.  Data......:
  160. ------------------------------------------------------------------------------
  161.  Close on exit (Y,N,blank)......: [ ]  Uses its own colors..............: [Y]
  162.  Allow Close Window command.....: [N]  Runs in background (Y,N,blank)...: [N]
  163.  Uses math coprocessor..........: [Y]  Keyboard conflict (0-F)..........: [0]
  164.  Share CPU when foreground......: [Y]  Share EGA when foreground/zoomed.: [Y]
  165.  Can be swapped out (Y,N,blank).: [Y]  Protection level (0-3)...........: [0]
  166.  
  167.   The Maximum Expanded Memory setting of 16 allows the VCPI detection to
  168. work. You can set this to 0 if you need to, or 9999 if you want Infoplus to
  169. detect it all (Infoplus does not actually use EMS at present.) The Maximum
  170. Program Size can also be varied if you wish.
  171.  
  172.   This version of INFOPLUS was compiled using the following equipment:
  173.  
  174.   Hardware:
  175.     Gateway 2000 386/25 (Micronics ASIC motherboard w/ 64K cache)
  176.     4 Meg RAM
  177.     Microscience 110M ESDI, 3.5" HH
  178.     Ultrastor 12F ESDI controller w/ 32K cache
  179.     ATI VGA Wonder w/ 512K RAM
  180.     Soundblaster (older version with CMS chips)
  181.  
  182.   Software:
  183.     MS-DOS 5.00
  184.     QEMM 6.00
  185.     4DOS 4.0
  186.     HyperDisk 4.30
  187.     Turbo Pascal 6.0
  188.     Turbo Assembler 2.0
  189.     Turbo Debugger 2.0
  190.     KEDIT 4.00D2
  191.     Windows 3.00
  192.     Desqview 2.40
  193.  
  194.   My primary sources of ideas in INFOPLUS were Ray Duncans "Advanced MS-DOS"
  195. and Terry Dettman's "DOS Programmer's Reference."  The ideas of Prakash
  196. Chandra,Terje Mathisen,Bob Smith, and others appear in various places.  Also
  197. James Howard, John Levine, Mark Aitchison, Jay Caplan, David Tay, Heribert
  198. Eisele.
  199.  
  200.   Some of the techniques INFOPLUS uses are not documented or officially
  201. supported by either IBM or Microsoft.  Where possible I have followed the
  202. undocumented routine with a comment describing my source for the technique.
  203.  
  204.   Much of the additional info came from Ray Duncan's "Advanced MSDOS
  205. Programming" second edition (a must get book for anyone interested in
  206. low-level stuff.)  Also, additional information on the DOS 4 boot sector
  207. format came from "The Norton Troubleshooter."  A book that comes with The
  208. Norton Utilities 4.5.
  209.  
  210.   Even more information comes from Ralf Brown's interrupt list, which lists
  211. hundreds of goodies.  It's available via BBS's, and resides on SIMTEL20 and
  212. many other public access UNIX sites.  It's also available on the Infoplus
  213. BBS.  The name is INTERxxy.ZIP, where xx is the version, and y is the part
  214. letter. (This version of Infoplus used INTER28.)
  215.  
  216.   Additional information on XMS and DPMI came from the book 'Extending DOS'
  217. by Ray Duncan (and others.)
  218.  
  219.   Information on additional partition values came from numerous people of
  220. which I never wrote down their names!!
  221.  
  222.   Information on detecting VGA chipsets came from "Advanced Programmer's
  223. Guide to Super VGAs" by George Sutty and Steve Blair.  Published by Brady.
  224. (NOTE!  Beware of bugs in the detection routines in the above book!!)
  225.  
  226.   Some extra VGA chipset detection help came for the source code for
  227. Fractint 16.11.
  228.  
  229.   Information on reading the CMOS came from a program posted by Mark
  230. Aitchison on USENET.
  231.  
  232.   Information on detecting UART types came from David Tay and David Nugent
  233. (david@csource.oz.au)
  234.  
  235.   More information on VGA chipsets came from "Programmer's Guide to the EGA
  236. and VGA Cards, Second Edition" by Richard F. Ferraro.  Published by
  237. Addison-Wesley.
  238.  
  239.   Information about how dangerous it is to pass too many flags, and info
  240. about OS/2 came from Heribert Eisele (heribert@caen.engin.umich.edu)
  241.  
  242.   How to detect the Tandy 1000, and some models digital sound, came from
  243. Frank Durda IV (uhclem@nemesis.lonestar.org)
  244.  
  245.   Information about a bug in the LONGCALL routine came from Michael Holin
  246. (HIMH%DCZTU1.BITNET@cunyvm.cuny.edu).
  247.  
  248.   Information about problems with Trident VGA chipsets came from MANY
  249. people.
  250.  
  251.   If you have any questions, bug reports, or suggestions, I can be
  252. reached at the following places:
  253.  
  254. Internet       : andyross@infopls.chi.il.us
  255. Unix           : uunet!infopls!andyross
  256. CompuServe     : >INTERNET:andyross@infopls.chi.il.us
  257. RIME/Relaynet  : ->DSBBS (try Shareware or Technical conferences)
  258.  
  259. Infoplus BBS   : (708)537-0247 (14400/9600/2400/1200 v32bis/v42bis/MNP)
  260.   This is my own BBS. You can always get the latest version here. Just log
  261. in as INFOPLUS, and follow the instructions on screen.
  262.  
  263. RCS Defender   : (708)390-6603 (2400/1200, 2 lines)
  264.                : (708)390-9662 (14400/9600/2400/1200 v32bis/v42bis/MNP)
  265. Beacon         : (708)615-0845 (2400/1200)
  266. Digital Systems: (708)398-1217 (2400/1200)
  267.  
  268.      Andrew Rossmann
  269.      Wheeling, IL
  270.  
  271. From Steve Grant:
  272.      Both the source and object code of SYSID are hereby released into the
  273.      public domain.  Neither version carries any warranty, expressed or
  274.      implied, of merchantability or fitness for a particular purpose.
  275.  
  276.      Comments, suggestions, and questions may be addressed to:
  277.              BIXMail: sjgrant
  278.              CompuServe: 71101,706
  279.  
  280.      Steve Grant
  281.      Long Beach, CA
  282.      January 13, 1989
  283.